docs: Community Landing Page by taniandjerry · Pull Request #2869 · block/goose

taniandjerry · 2025-06-12T00:00:20Z

This pull request introduces an exciting new landing page:

The home to our Public Events Calendar and Community Spotlight!

community.landing.page.mov

But that's not all...

The community spotlight has also become Community All Stars program!

This program is where EVERY contributor is highlighted, including team members across Block! Here's how:

Each month, the list of all contributors to the block/goose project are pulled from GitHub, and are then analyzed and populated into the following lists by goose & @taniashiba:

Community Stars - This list consists of the top 5 contributors from the external community
Team Stars - This list consists the top 5 contributors from the internal community, aka the goose team and any contributors from Block!
Monthly Leaderboard - This lists consists of all contributors for the month, both internal and external members.

The best part? This landing page was made with help from goose!

This landing page is linked in the bottom nav bar currently.

The url is http://block.github.io/goose/community, and the label in the bottom nav menu is Spotlight. This can be changed!

To update this community landing page each month is relatively simple:

Create new month file

Go to goose/documentation/src/data/community/
Copy template.json → rename to [month]-[year].json (e.g., june-2025.json)
Fill in the data:
- communityStars: 5 external contributors (name + GitHub handle)
- teamStars: 5 Block team contributors (name + GitHub handle)
- leaderboard: All contributors ranked with medals for top 3

Update config

Open config.json in same folder • Add new month to availableMonths array • Update defaultMonth to show new month by default

Update community.tsx

Go to goose/documentation/src/pages/community.tsx and add the import for your new JSON file at the top, add it also to the communityDataMap object. For example:
- Add import line: import june2025Data from "../data/community/june-2025.json"; •
- Add to data map: "june-2025": june2025Data,

Test & Deploy!

Quick Tips

Use GitHub handles - avatars will load automatically.
Use "handle": "TBD" for placeholders
Only top 3 get medals in the leaderboard 🥇🥈🥉
File naming: month-year.json format

That's basically it! You can also use goose to do this update in a commit, so long as you have the three lists mentioned above ( communityStars, teamStars, and leaderboard)

github-actions · 2025-06-12T00:02:25Z

PR Preview Action v1.6.0
Preview removed because the pull request was closed.
2025-06-16 21:34 UTC

taniandjerry · 2025-06-12T00:08:06Z

Main help I could use other than general ♻️ review is the link label:

Currently, it's labeled Spotlight, and the url is block.github.io/goose/community. Which works well! But open to suggestions. It lives here because the top is already cluttered, and I don't want to take away from our top two links (to GitHub and Discord).

cc @angiejones @blackgirlbytes

blackgirlbytes · 2025-06-12T05:09:58Z

I loooove thsi. This is a super nitpick, but the numbers/words for the to community ppl could have better contrast

agiuliano-square

This page is FANTASTIC! I'm obsessed. It looks like Goose made some interesting decisions WRT implementation, so I think we can clean this up a bit, but it's all small things. Great job @taniashiba!

agiuliano-square · 2025-06-12T17:34:33Z

documentation/src/data/community/README.md

For consistency's sake, I think it might be better to create a "community" folder under "pages" and then put this "data" folder within that "community" folder. That way it will be structured the same way as the prompt-library folder.

Ohhhhh gotcha! That's a good point, thank you Anthony!

agiuliano-square · 2025-06-12T17:36:38Z

documentation/src/data/community/april-2025.json

+      "handle": "lily-de"
+    }
+  ],
+  "leaderboard": [


I'm curious where is this data being pulled from. I wonder if this can just be reduced to an array with each of the handles and then just use the order to determine the rank instead of having a separate "rank" field. That said, if the place you're pulling the data from structures it like this then I think it would be better to keep it as is.

The list of people was provided to goose, which consists of all GitHub handles that goose found! Except two people, which is where I provided an avatar URL from Discord.

The rank is provided in the list given to goose by me, so it is technically already ranked! I think goose added this in case I wanted to change someone's rank after the fact as I was working through it. 🤔

agiuliano-square · 2025-06-12T17:39:54Z

documentation/src/pages/community.tsx

+import Layout from "@theme/Layout";
+import Heading from "@theme/Heading";
+
+import styles from "./index.module.css";


I don't believe this is actually used anywhere. Can probably get rid of it

we may have to make the commits for Tania since she doesn't code regularly!

Absolutely! I can take a stab at this. @taniashiba sorry to throw a bunch of comments at you! I wasn't sure what you're coding experience was like.

Oh no worries at all, all comments welcome! I don't code regularly, but have a general working understanding I'd say. 😉 I do well with some guidance and pick up things faster than you'd think, I'd say! 🥺

I did work with goose to try to get rid of some of this fluff, because it kept what was no longer used from past iterations for sure!

Thank yall for taking the time <3 If you wouldn't mind, after your review together, would you be able to give me a list of general guidelines I could give to goose to avoid leaving random bloat & making weird choices to the layout styling? 🙏 I know if I can specifically state what to do vs what not to change, I can make future changes easier!

Of course! I think that's a great idea

agiuliano-square · 2025-06-12T17:42:31Z

documentation/src/pages/community.tsx

+  return (
+    <section className="container margin-vert--lg">
+      <div className="row">
+        <div className="col col--12">


Looks like Goose made some interesting style decisions in this file. Based on what I've seen in other files in this directory, it looks like Tailwind is the prevailing styling method. I think the whole file could probably benefit from a pass at converting everything to tailwind. I'm happy to assist with this if you'd like

yeah i think both of us can team up and convert this to following the site's styling and format.

That would be awesome! I tried to tell goose to use Tailwind actually, but goose just didn't change it. So I was like okay, let me leave it be for now I guess 🙏

agiuliano-square · 2025-06-12T17:43:44Z

documentation/src/pages/community.tsx

+                  avatar.style.transform = 'rotate(0deg)';
+                }
+              }}
+            >


These onMouse functions can probably be traded for hover effects. Tailwind should help with that.

agiuliano-square · 2025-06-12T17:45:42Z

documentation/src/pages/community.tsx

+                    style={{ 
+                      display: 'flex', 
+                      alignItems: 'center', 
+                      padding: bgColor ? '12px' : '10px', 


I know technically the bgColor indicates that this is a top 3 contributor, but semantically this doesn't quite read right to me. Maybe we create a separate variable to capture this and then style everything based on that variable.

true. good catch!

agiuliano-square · 2025-06-12T17:46:13Z

documentation/src/pages/community.tsx

+                gap: '6px',
+                transition: 'opacity 0.3s ease'
+              }}>
+                Scroll for more ↓


nit: could maybe use a background color here to improve readability

- Move community data files from src/data/community/ to src/pages/community/data/ - Rename community.tsx to community/index.tsx for better organization - Consolidate community-related files under src/pages/community/

agiuliano-square · 2025-06-16T15:41:29Z

Committed some changes to move to Tailwind. This is certainly not perfect, but I think it's passable for now. There are more changes I'd like to make in the future, but I think those will require larger refactors (i.e componentizing different elements, updating tailwind config, etc.) I'm happy to start to chip away at some of those refactors next quarter if folks would find that beneficial.

@blackgirlbytes feel free to take a pass at this if there is anything you don't like.

bin/hermit

blackgirlbytes · 2025-06-16T15:54:52Z

Committed some changes to move to Tailwind. This is certainly not perfect, but I think it's passable for now. There are more changes I'd like to make in the future, but I think those will require larger refactors (i.e componentizing different elements, updating tailwind config, etc.) I'm happy to start to chip away at some of those refactors next quarter if folks would find that beneficial.

@blackgirlbytes feel free to take a pass at this if there is anything you don't like.

hmm @agiuliano-square yeah there are a few things I want to fix but will take me a minute. I agree that tania could merge for now and then we do a refactor.

taniandjerry · 2025-06-16T17:13:20Z

Committed some changes to move to Tailwind. This is certainly not perfect, but I think it's passable for now. There are more changes I'd like to make in the future, but I think those will require larger refactors (i.e componentizing different elements, updating tailwind config, etc.) I'm happy to start to chip away at some of those refactors next quarter if folks would find that beneficial.
@blackgirlbytes feel free to take a pass at this if there is anything you don't like.

hmm @agiuliano-square yeah there are a few things I want to fix but will take me a minute. I agree that tania could merge for now and then we do a refactor.

Thank you Rizel! I re-requested review from yall, then once it's merged the refactor can be done. Thank you so much for all your help 🥺

taniandjerry · 2025-06-16T20:12:20Z

Made two minor CSS changes to format okay with 3 top stars vs 5, and then updated both month's team star lists. The leaderboard still includes the goose dev team and the devrel team because without them the leaderboard would be limited!

Co-authored-by: Tania Chakraborty <tchakraborty@block.xyz> Co-authored-by: Anthony Giuliano <agiuliano@squareup.com>

Co-authored-by: Tania Chakraborty <tchakraborty@block.xyz> Co-authored-by: Anthony Giuliano <agiuliano@squareup.com> Signed-off-by: Soroosh <soroosh.sarabadani@gmail.com>

Co-authored-by: Tania Chakraborty <tchakraborty@block.xyz> Co-authored-by: Anthony Giuliano <agiuliano@squareup.com>

Tania Chakraborty added 22 commits June 11, 2025 13:57

added link

af8b95b

created community page

5261d0b

created sections

232dcf7

box content

462eb4d

changes so far

770a035

profile boxes

80d2fe2

nice state

f9ce5f3

multiple rows

0022606

all contributors list

25393e3

months tabs

e1197e1

great state

a2f9984

updated stars

1e953b9

current

8596574

updated month selected

3a34e85

styling

4be7434

changed structure

d336237

leaderboard styling

65137a1

cute effects

5bece4a

scrollbar

d37cc3a

more styling changes

a8edcb5

last changes

4df5f61

label

1df3868

taniandjerry self-assigned this Jun 12, 2025

taniandjerry added the documentation Improvements or additions to documentation label Jun 12, 2025

taniandjerry requested review from EbonyLouis, acekyd, angiejones and blackgirlbytes June 12, 2025 00:08

taniandjerry requested a review from agiuliano-square June 12, 2025 00:09

agiuliano-square reviewed Jun 12, 2025

View reviewed changes

agiuliano-square added 2 commits June 12, 2025 15:36

Refactor community page file structure

9332449

- Move community data files from src/data/community/ to src/pages/community/data/ - Rename community.tsx to community/index.tsx for better organization - Consolidate community-related files under src/pages/community/

converting styles to tailwind

16df1db

blackgirlbytes reviewed Jun 16, 2025

View reviewed changes

bin/hermit Outdated Show resolved Hide resolved

blackgirlbytes reviewed Jun 16, 2025

View reviewed changes

bin/hermit Outdated Show resolved Hide resolved

reverting changes to hermit file

471397d

taniandjerry requested review from agiuliano-square and blackgirlbytes and removed request for EbonyLouis and acekyd June 16, 2025 17:12

agiuliano-square approved these changes Jun 16, 2025

View reviewed changes

blackgirlbytes approved these changes Jun 16, 2025

View reviewed changes

Tania Chakraborty added 3 commits June 16, 2025 15:50

top stars update

a0d517f

removed space

4930ac3

dynamic css count

097d90b

taniandjerry merged commit 516e5fe into main Jun 16, 2025
8 checks passed

taniandjerry deleted the community-landingpage branch June 16, 2025 21:33

taniandjerry mentioned this pull request Jun 16, 2025

docs: Update Leaderboard in New Community Landing Page #2954

Merged

chaitanyarahalkar mentioned this pull request Jun 24, 2025

chaitanyarahalkar/elicitation support mcp chaitanyarahalkar/goose#4

Open

btdeviant pushed a commit to btdeviant/goose that referenced this pull request Jun 25, 2025

docs: Community Landing Page (block#2869)

ec07a58

Co-authored-by: Tania Chakraborty <tchakraborty@block.xyz> Co-authored-by: Anthony Giuliano <agiuliano@squareup.com>

cbruyndoncx pushed a commit to cbruyndoncx/goose that referenced this pull request Jul 20, 2025

docs: Community Landing Page (block#2869)

a1292af

Co-authored-by: Tania Chakraborty <tchakraborty@block.xyz> Co-authored-by: Anthony Giuliano <agiuliano@squareup.com>

Conversation

taniandjerry commented Jun 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

This pull request introduces an exciting new landing page:

The community spotlight has also become Community All Stars program!

This landing page is linked in the bottom nav bar currently.

To update this community landing page each month is relatively simple:

Quick Tips

Uh oh!

github-actions bot commented Jun 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

taniandjerry commented Jun 12, 2025

Uh oh!

blackgirlbytes commented Jun 12, 2025

Uh oh!

agiuliano-square left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

taniandjerry Jun 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

agiuliano-square commented Jun 16, 2025

Uh oh!

Uh oh!

Uh oh!

blackgirlbytes commented Jun 16, 2025

Uh oh!

taniandjerry commented Jun 16, 2025

Uh oh!

taniandjerry commented Jun 16, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

taniandjerry commented Jun 12, 2025 •

edited

Loading

github-actions bot commented Jun 12, 2025 •

edited

Loading

taniandjerry Jun 12, 2025 •

edited

Loading